Política de Retentativa de Mensagens
Fluxo de Entrega de Mensagens
Detalhes da Política
Tentativas de Entrega
- Número máximo de tentativas: 5
- Intervalo entre tentativas: 10 minutos
- Tempo total: ~50 minutos (da primeira à última tentativa)
Armazenamento de Mensagens
| Status | Localização | Tempo de Retenção | Ação Final |
|---|---|---|---|
| Aguardando processamento | Tópico Principal | Até ser processada | Movida para entrega |
| Falha na entrega | Tópico de Retentativa | Até 5 tentativas | Movida para mensagens mortas |
| Tentativas esgotadas | Tópico de Mensagens Mortas | 7 dias | Exclusão permanente |
Arquitetura Técnica
O SantoID utiliza um sistema de mensagens baseado em PubSub com:
-
Tópico Principal
- Recebe todas as requisições assíncronas
- Encaminha para processamento
-
Tópico de Retentativa
- Armazena mensagens não entregues
- Dispara retentativas automáticas
- Implementa backoff exponencial
-
Tópico de Mensagens Mortas
- Armazenamento temporário final
- Período de recuperação de 7 dias
- Exclusão automática após expiração
Recomendações
- Monitore a disponibilidade do seu Webhook
- Implemente tratamento de idempotência
- Mantenha logs das mensagens recebidas
- Verifique regularmente os e-mails de notificação
Boas Práticas Adicionais
- Implemente confirmação de recebimento - Seu endpoint deve retornar HTTP 200 para confirmar o processamento
- Trate adequadamente os erros - Analise os códigos de erro retornados
- Configure alertas proativos - Para ser notificado sobre falhas persistentes
- Documente os fluxos - Mantenha um registro dos padrões de mensagens esperados